home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 April / macformat-023.iso / Shareware City / Developers / RLaB / help / read < prev    next >
Encoding:
Text File  |  1994-08-31  |  1.1 KB  |  38 lines  |  [TEXT/RLAB]
  1. read:
  2.  
  3. Syntax:    read ( "filename" )
  4.     read ( "filename" , L )
  5.  
  6. Description:
  7.  
  8.     read() reads the file identified by the "filename". The file
  9.     is opened with read access, and all of the contents are read.
  10.     The file identified by the 1st argument must contain data that
  11.     is in RLaB format.  The entities in the file are installed in
  12.     the global symbol table, overwriting any existing
  13.     entities. Upon completion the file is closed.
  14.  
  15.     Example:
  16.  
  17.         read("bunch_of_data_in_a_file");
  18.  
  19.     The second form of the read function allows the data in the
  20.     file to be read into a list variable L. The
  21.     global-symbol-table is untouched (except for L).
  22.  
  23.     Example:
  24.  
  25.         read("bunch_of_data", X);
  26.  
  27.     The contents of the file `bunch_of_data' are read and stored
  28.     in the list variavle X. Except for the creation/modification
  29.     of the variable X, the global-symbol-table is unchanged.
  30.  
  31. See Also: FILES, close, getline, open, readb, readm, write, writeb, 
  32.           writem
  33.  
  34. Future Enhancements:
  35.  
  36.     read() should have the option to list the contents of a file
  37.     without actually reading them into the symbol table. 
  38.